home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / DOSUTILS / MIDIFMT.DOC < prev    next >
Text File  |  1997-03-09  |  4KB  |  129 lines
  1.         ******************************
  2.             MIDIFMT v1.1
  3.     
  4.             midi track information
  5.               by Guenter Nagler 
  6.                 1995 
  7.           (gnagler@ihm.tu-graz.ac.at)
  8.         ******************************
  9.  
  10. [1] BACKGROUND
  11. When programming other midi utilities (e.g. MIDI0TO1) I needed 
  12. special formatted midi files to test the utilities.
  13. To distinguish the different format 0,1,2 midi files I wrote this
  14. simply program.
  15. The different format versions of standard midi currently are:
  16.   0: single multichanneltrack
  17.   1: several tracks with seperated channels to play all at once
  18.   2: several multichanneltracks to play one by one
  19.  
  20. [2] FILES DESCRIPTION
  21.  
  22. MIDIFMT.EXE.........
  23. MIDIFMT.DOC.........this file, showing usage of MIDIFMT.EXE
  24. MIDIIO.HPP..........header file for a c++ midi parser
  25. MIDIIO.CPP..........source code for a c++ midi parser
  26. MIDIFMT.CPP.........c++ source code for midi to text
  27. MIDIFMT.MAK.........make file for project 
  28. MIDIFMT.CFG.........compiler options for make
  29. MIDIFMT.PRJ.........project for borland c++ compilers
  30. only MIDIFMT.EXE is required to run program
  31.  
  32. [3] COPYRIGHT
  33.  
  34. MIDIFMT (c) 1995 was created by Guenter Nagler.
  35.  
  36. MIDIFMT is free and may be used as you wish with this one exception:
  37.  
  38.     You may NOT charge any fee or derive any profit for distribution
  39.     of MIDIFMT.  Thus, you may NOT sell or bundle MIDIFMT with any 
  40.     product in a retail environment (shareware disk distribution, CD-ROM,
  41.     etc.) without permission of the author.
  42.  
  43. You may give MIDIFMT to your friends, upload it to a BBS, or ftp it to
  44. another internet site, as long as you don't charge anything for it.
  45.  
  46. [4] DISCLAIMER
  47.  
  48. Use MIDIFMT at your own risk.  Anything you do with MIDIFMT is your
  49. responsibility, and not the author's.  Any damage caused to any person,
  50. computer, software, hardware, company, or business by running MIDIFMT 
  51. is your responsibility, and the author will not be liable.
  52.  
  53. If you don't understand these terms, or are not sure of something, or
  54. are afraid something bad might come of using MIDIFMT, don't  use  it!
  55. You are here forewarned.
  56.  
  57. [5] INSTALLATION 
  58.  
  59. [MSDOS]
  60.  
  61.   Simply copy MIDIFMT.EXE in a directory that is in your path.
  62.   When you start the program without arguments
  63.  
  64.   C:\> MIDIFMT
  65.  
  66.   you should get the usage text (see next section)
  67.  
  68. [UNIX]
  69. compile sources with your C++ compiler (e.g. GNU Compiler g++):
  70.  
  71. g++ -o midifmt midifmt.cpp midiio.cpp 
  72.  
  73. and run program
  74.  
  75. $ midifmt
  76.  
  77. [6] USAGE
  78.  
  79. usage: MIDIFMT *.mid ... 
  80.  
  81. The text output is normally written to screen but can be relinked
  82. to a file  (> filename.txt)  or a printer (> prn). See your MS-DOS/UNIX
  83. manual for usage of  > and >> operators.
  84.  
  85. You can use the filename wildcards that your system supports:
  86. DOS:  *    endings are free   e.g.   F*.MID  matches all midifiles that 
  87.        begin with F
  88.       ?       match any character but .  F???.MID matches all midifiles that 
  89.         begin with F and have 4 characters
  90.  
  91. UNIX:  *   match 0 or more characters
  92.        ?   match exactly one character
  93.        [...] match character that is in a given set
  94.        etc. see your manual of your work shell (e.g. man sh) for details
  95.  
  96. [7] A sample of resulting text output
  97.  
  98. command> midifmt *.mid
  99. sample.mid: version 0, 1 track
  100. original.mid: version 1, 13 tracks
  101.  
  102. shows a list of matching filenames, the version number (0-2) and the
  103. number of tracks.
  104.  
  105. command> midifmt notavail.mid
  106. notavail.mid not found
  107.  
  108. The file notavail.mid does not exist or there is no permission to read the 
  109. file.
  110.  
  111. command> midifmt file4.mid file1*.mid
  112. file4.mid: version 1, 1 track
  113. file1.mid: version 1, 3 tracks
  114. file17.mid: version 0, 1 track
  115.  
  116. You can use more than one arguments and mix filenames and filename wildcards.
  117. Here you see that file1*.mid matched file1.mid and file17.mid.
  118.  
  119. [8] SUGGESTIONS / COMMENTS / BUG REPORTS / QUESTIONS
  120.  
  121.          WWW:    http://hgiicm.tu-graz.ac.at/Cpub
  122.           contains all my dos/unix midi programs
  123.          EMAIL:  gnagler@ihm.tu-graz.ac.at
  124.  
  125. [9] CHANGES
  126. v1.0 to v1.1:
  127.   * long filename support for DOS 7.0/Windows95
  128.  
  129.